PARTEA a II-a : Implementarea de aplicatii OpenGL folosind biblioteca GLUT OpenGL este o interfata de programare formata din circa 150 de functii care pot fi folosite pentru modelarea si vizualizarea scenelor 3D Doua aspecte importante au determinat cresterea continua a popularitatii sale : * Functiile OpenGL sunt independente de platforma hardware-software * OpenGL ofera functii de sinteza de nivel înalt, care sunt realizate fie software fie prin echipamente grafice specializate In prezent exista implementari OpenGL pentru sistemele de operare Microsoft Windows, Unix si IBM PS/2 Acestea se prezinta sub forma unor biblioteci integrate (sau care pot fi integrate) în mediile de dezvoltare a aplicatiilor Deoarece OpenGL nu contine functii de gestiune a ferestrelor de afisare si interactiune cu utilizatorul, implementarile OpenGL sunt completate cu astfel de functii O asemenea implementare extinsa este si GLUT (OpenGL Utilities Toolkit), la a carei utilizare ne referim în aceasta parte a îndrumarului Dintre functiile de sinteza de nivel înalt oferite de OpenGL mentionam: > Maparea texturilor: aplicarea de imagini pe suprafete 3D > Eliminarea automata din imagini a partilor nevizibile ale obiectelor prin algoritmul Z-buffer ; > Efecte de iluminare a scenelor 3D folosind diferite modele de iluminare si una sau mai multe surse de lumina; > Simularea reflexiei si a transmisiei luminii tinând cont de proprietatile materialelor ; > Transformarea din spatiul 3D utilizator în spatiul 2D ecran prin specificarea matricelor de transformare, posibilitatea de a modifica pozitia si dimensiunea obiectelor în spatiul 3D utilizator Exista de asemenea functii care permit generarea simpla a unor obiecte solide, curbe si suprafete de forma libera precum si functii de lucru cu imagini II 1 Conventii de numire a functiilor, constantelor si tipurilor de date OpenGL Numele functiilor OpenGL contin prefixul gl (de exemplu glClearColor) iar constantele prefixul GL (de exemplu GL COLOR BUFFER BIT) Declaratiile functiilor OpenGL sunt de forma: void glFunction{nr}{b s i f d}{v}(argumente); nr - reprezinta numarul de argumente ale functiei b sau s sau i sau f sau d sau v - specifica tipul argumentelor functiei, iar v daca argumentele functiei sunt date sub forma de vector (b - byte, s - short, i - int, f - float, d - double, v - vector) Exemple : glVertex2i(1, 3); glVertex2f(1 0, 3 0); Primul apel furnizeaza coordonatele vârfurilor ca întregi pe 32 biti iar al 2-lea ca numere reale (în formatul cu virgula mobila) glColor3f(1 0, 0 0, 0 0); GLfloat color array[] = {1 0, 0 0, 0 0}; glColor3fv(color array); Functia glColor3f() seteaza culoarea de desenare si are 3 parametri ce corespund componentelor rosu, verde si albastru, iar functia glColor3fv() seteaza culoarea de desenare având ca parametru un vector ce contine componentele culorii Tipuri de date OpenGL Pentru un acelasi tip de date în C, diferitele implementari OpenGL pot alege tipuri diferite Pentru portabilitate, indiferent de implementarea OpenGL se recomanda utilizarea tipurilor de date definite în OpenGL Acestea sunt prezentate in tabelul II 1 OpenGL defineste si tipul GLvoid Acesta este cel mai adesea folosit în apelurile de functii OpenGL care accepta pointeri la vectori de valori Sufix Tipul de date Corespondentul în C Tipul definit în OpenGL b 8-bit integer signed char GLbyte s 16-bit integer Short GLshort i 32-bit integer int sau long GLint, GLsizei f 32-bit floating-point Float GLfloat, GLclampf d 64-bit floating-point Double GLdouble, GLclampd ub 8-bitunsigned integer unsigned char GLubyte, GLboolean us 16-bit unsigned integer unsigned short GLushort ui 32-bit unsigned integer unsigned int sau unsigned long GLuint,GLenum, GLbitfield Tabelul II 1 Tipuri de date OpenGL II 2 Functii GLUT de realizare a interfetei cu utilizatorul II 2 1 Gestiunea ferestrelor Initializare fereastra void glutInit(int *argc, char **argv); Functia glutInit() initializeaza variabilele interne ale pachetului de functii GLUT si proceseaza argumentele din linia de comanda Ea trebuie sa fie apelata înaintea oricarei alte comenzi GLUT Parametrii functiei au aceeasi semificatie ca si parametri functiei main Initializare mod de afisare void glutInitDisplayMode(unsigned int mode); unde mode specifica modul de afisare: * folosirea modelului RGBA (culoarea se specifica prin componentele sale rosu, verde, albastru si transparenta sau opacitatea) sau a modelului de culoare bazat pe indecsi de culoare În general se recomanda folosirea modelului RGBA * folosirea unei ferestre cu un singur buffer sau cu buffer dublu, pentru realizarea animatiei * folosirea bufferului de adâncime pentru algoritmul z-buffer De exemplu, daca se doreste crearea unei ferestre cu buffer dublu ce foloseste un model de culoare RGBA si buffer pentru algoritmul z-buffer, se va apela: glutInitDisplayMode(GLUT DOUBLE |GLUT RGB |GLUT DEPTH; Initializare pozitie fereastra void glutInitWindowPosition(int x, int y) ; Functia glutInitWindowPosition specifica coltul stânga sus al ferestrei în coordonate relative la coltul stânga sus al ecranului Initializare dimensiune fereastra void glutInitWindowSize(int width, int height) ; Functia glutInitWindowSize specifica dimensiunea în pixeli a ferestrei : latimea (width) si înaltimea (height) Creare fereastra int glutCreateWindow(char *string) ; Functia glutCreateWindow creeaza o fereastra cu un context OpenGL Ea intoarce un identificator unic pentru fereastra nou creata Fereastra nu va fi afisata înainte de apelarea functiei glutMainLoop Valoarea întoarsa de functie reprezinta identificatorul ferestrei, care este unic Creare ferestre copil int glutCreateSubWindow(int win, int x, int y, int width, int height); Functia creeaza o fereastra având ca parinte fereastra identificata de win, unde : - win - reprezinta identificatorul ferestrei parinte; - (x, y) - reprezinta coltul stânga sus al ferestrei (x si y sunt exprimate în pixeli si sunt relative la originea ferestrei parinte); - width - reprezinta latimea ferestrei (exprimata în pixeli); - height - reprezinta înaltimea ferestrei (exprimata în pixeli); Fereastra nou creata devine fereastra curenta Functia întoarce identificatorul ferestrei create Distrugere fereastra void glutDestroyWindow(int win) ; Functia distruge fereastra specificata de win De asemenea, este distrus si contextul OpenGL asociat ferestrei Orice subfereastra a ferestrei distruse va fi de asemenea distrusa Daca win identifica fereastra curenta, atunci ea va deveni invalida Selectarea ferestrei curente void glutSetWindow(int win) ; Functia selecteaza fereastra curenta ca fiind cea identificata de parametrul win Aflarea ferestrei curente int glutGetWindow(void) ; Functia întoarce identificatorul ferestrei curente Functia întoarce 0 daca nu exista nici o fereastra curenta sau fereastra curenta a fost distrusa Selectarea cursorului asociat ferestrei curente void glutSetCursor(int cursor) ; Functia modifica cursorul asociat ferestrei curente transformându-l în cursorul specificat de parametrul cursor, care poate avea una din urmatoarele valori: GLUT CURSOR RIGHT ARROW, GLUT CURSOR LEFT ARROW, GLUT CURSOR WAIT, GLUT CURSOR HELP, GLUT CURSOR TEXT, GLUT CURSOR CROSSHAIR, GLUT CURSOR UP DOWN, GLUT CURSOR LEFT RIGHT, GLUT CURSOR TOP SIDE, GLUT CURSOR BOTTOM SIDE, GLUT CURSOR LEFT SIDE, GLUT CURSOR RIGHT SIDE, GLUT CURSOR TOP LEFT CORNER, GLUT CURSOR TOP RIGHT CORNER, GLUT CURSOR BOTTOM RIGHT CORNER, GLUT CURSOR BOTTOM LEFT CORNER, GLUT CURSOR NONE, GLUT CURSOR INHERIT (foloseste cursorul asociat ferestrei parinte) II 2 2 Gestiunea meniurilor Crearea meniurilor Meniurile create cu ajutorul GLUT-ului sunt meniuri simple, pop-up în cascada În timp ce un meniu este folosit el nu poate fi sters, nu i se pot adauga alte optiuni si nu i se pot sterge din optiuni int glutCreateMenu(void (*func)(int value)) ; Functia creeaza un nou meniu pop-up si întoarce identificatorul sau (întreg unic) Identificatorii meniurilor încep de la valoarea 1 Valorile lor sunt separate de identificatorii ferestrelor - parametrul func specifica o functie callback a aplicatiei, care va fi apelata de biblioteca GLUT la selectarea unei optiuni din meniu Parametrul transmis functiei callback (value) specifica optiunea de meniu selectata Adaugarea unei optiuni într-un meniu void glutAddMenuEntry(char* name, int value) ; Functia adauga o noua optiune meniului curent Optiunea este adaugata la sfârsitul listei de articole a meniului - name - specifica textul prin care va fi reprezentata optiunea introdusa - value - reprezinta valoarea transmisa functiei callback asociata meniului la selectarea optiunii respective Adaugarea unui sbmeniu într-un meniu void glutAddSubMenu(char* name, int menu) ; Functia adauga un submeniu la sfârsitul meniului curent - name - reprezinta numele submeniului introdus (textul prin care va fi afisat în meniu) - menu - reprezinta identificatorul submeniului Stergerea unei optiuni sau a unui submeniu void glutRemoveMenuItem(int entry) ; Functia sterge optiunea sau submeniul identificat de parametrul entry Optiunile din meniu de sub optiunea stearsa sunt renumerotate Distrugerea unui meniu void glutDestroyWindow(int menu) ; Functia distruge meniul specificat prin parametru Distrugerea unui meniu nu are nici un efect asupra submeniurilor Daca meniul distrus este cel curent, atunci meniul curent va deveni invalid Setarea meniului curent void glutSetMenu(int menu) ; Functia seteaza meniul curent ca fiind cel identificat de parametrul menu Aflarea meniului curent int glutGetMenu(void) ; Functia întoarce identificatorul meniului curent Functia întoarce 0 daca nu exista meniu curent sau meniul curent a fost distrus Atasare / detasare meniu unui buton al mouse-ului void glutAttachMenu(int button) ; void glutDetachMenu(int button) ; Functia glutAttachMenu ataseaza meniul curent butonului mouse-ului specificat de parametrul button Functia glutDetachMenu detaseaza butonul asociat meniului curent Prin atasarea unui buton al mouse-ului meniului curent, meniul va fi derulat la apasarea butonului respectiv în pozitia curenta a cursorului II 2 3 Controlul evenimentelor de intrare In categoria evenimentelor de intrare sunt incluse evenimentele provocate de apasarea unei taste sau a unuia dintre butoanele mouse-ului, de deplasarea mouse-ului si de redimensionarea ferestrei de afisare de catre utilizator Pentru fiecare dintre aceste tipuri de evenimente programatorul trebuie sa specifice o functie callback care va fi apelata la producerea unui eveniment de tipul respectiv Functiile GLUT mentionate în continuare servesc acestui scop Redimensionarea ferestrei void glutReshapeFunc(void (*func)(int width, int height)) ; Parametrul functiei glutReshapeFunc indica functia callback care va fi apelata la redimensionarea ferestrei Parametrii width si height transmisi functiei callback reprezinta noile valori ale latimii si înaltimii ferestrei Apasarea / eliberarea unei taste void glutKeyboardFunc(void (*func)(unsigned char key, int x, int y)) ; Parametrul func reprezinta functia callback care va fi apelata la apasarea / eliberarea unei taste care genereaza un caracter ASCII Parametrul key al functiei callback reprezinta valoarea ASCII Parametrii x si y indica pozitia mouse-ului la apasarea tastei (pozitie specificata în coordonate fereastra) Apasarea / eliberarea unui buton al mouse-ului void glutMouseFunc(void (*func)(int button, int state, int x, int y)) ; Parametrul func specifica functia callback care va fi apelata la apasarea / eliberarea unui buton al mouseului Parametrul button al functiei callback poate avea una din urmatoarele valori: GLUT LEFT BUTTON, GLUT MIDDLE BUTTON sau GLUT RIGHT BUTTON Parametrul state poate fi GLUT UP sau GLUT DOWN dupa cum butonul mouse-ului a fost apasat sau eliberat Parametrii x si y reprezinta pozitia mouse-ului la aparitia evenimentului Valorile x si y sunt relative la coltul stânga sus al ferestrei aplicatiei Deplasarea mouse-ului void glutMotionFunc(void (*func)(int x, int y)) ; Se specifica functia callback care va fi apelata la deplasarea mouse-ului în timp ce un buton este apasat Parametrii x si y reprezinta pozitia mouse-ului în momentul apasarii tastei Valorile x si y sunt relative la coltul stânga sul al ferestrei aplicatie II 2 4 Afisarea textelor Pentru afisarea unui caracter se apeleaza functia glutStrokeCharacter : void glutStrokeCharacter(void *font, int character); - font specifica fontul vectorial folosit, care poate avea una din urmatoarele valori: * GLUT STROKE ROMAN * GLUT STROKE MONO ROMAN - character specifica caracterul ce va fi afisat Exemplu Functia output prezentata mai jos realizeaza afisarea unui text cu format, incepand dintr-o pozitie specificata a ferestrei curente void output(GLfloat x, GLfloat y, char *format, ) { va list args; char buffer , *p; va start(args, format); vsprintf(buffer, format, args); va end(args); glPushMatrix(); glTranslatef(x, y, 0); for (p = buffer; *p; p++) glutStrokeCharacter(GLUT STROKE ROMAN, *p); glPopMatrix(); } II 3 Executia aplicatiei Functia de afisare callback void glutDisplayFunc(void (*func)(void)) ; Parametrul functiei glutDisplayFunc specifica functia callback a aplicatiei care va fi apelata de GLUT pentru afisarea continutului initial al ferestrei aplicatiei precum si ori de câte ori trebuie refacut continutul ferestrei ca urmare a cererii explicite a aplicatiei, prin apelul functiei glutPostRedisplay() Bucla de executie a aplicatiei void glutMainLoop(void) ; Aceasta este ultima functie care trebuie apelata in functia main a aplicatiei Ea contine bucla de executie (infinita) a aplicatiei în care aplicatia asteapta evenimente Orice eveniment este tratat prin rutina callback specificata anterior în functia main, prin apelul functiei GLUT specifice tipului de eveniment Executia unui proces în background void glutIdleFunc(void (*func)(void)) ; Parametrul transmis functiei glutIdleFunc este o functie callback care va fi executata in perioadele în care nu exista evenimente în curs de tratare sau în asteptarea tratarii - functia idle Daca argumentul functiei glutIdleFunc este NULL atunci functia idle existenta este dezactivata Terminarea afisarii O aplicatie GLUT poate rula pe mai multe masini De exemplu, sa presupunem ca programul principal este rulat pe o masina client si rezultatul procesarii (imaginea afisata) apare pe un terminal sau pe o statie de lucru (server), care este conectat în retea De obicei clientul aduna o colectie de comenzi într-un singur pachet înainte de a-l trimite în retea Codul de retea de la client nu permite detectarea momentului în care programul grafic a terminat desenarea unui cadru sau a unei scene 3D Astfel, clientul poate astepta la infint comenzi de desenare ca sa completeze un pachet Pentru a forta clientul sa trimita pachetul chiar daca nu este plin se foloseste functia glFlush void glFlush(void); În cazul în care nu exista nici un client si toate comenzile sunt executate pe server functia glFlush nu va avea nici un efect Pentru ca un program sa functioneze corect atât în retea cât si pe o singura masina, se va include apelul functieie glFlush la sfârsitul fiecarei scene Functia glFlush nu asteapta terminarea desenarii, ci doar forteaza începerea executiei desenarii Daca folosirea functiei glFlush nu este suficienta pentru o aplicatie, atunci se va folosi si functia glFinish Aceasta functioneaza ca si glFlush dar asteapta raspuns de notificare de la echipamentul grafic de indicare a terminari desenarii glFinish se va folosi pentru sincronizarea task-urilor void glFinish(void); Observatie: folosirea excesiva a lui glFinish poate reduce performantele aplicatiei mai ales daca se lucreaza în retea Daca este suficienta folosirea functiei glFlush se va folosi aceasta în locul functiei glFinish II 4 Crearea unei aplicatii OpenGL folosind GLUT Pentru a crea executabilul corespunzator unei aplicatii OpenGL se va deschide fisierul sursa * C cu Microsoft Visual C++ În momentul în care se va compila programul, mediul Visual C++ va genera automat un proiect în care va fi inclus fisierul sursa anterior deschis Pentru editarea legaturilor trebuie adaugate bibliotecile opengl32 lib, glu32 lib si glut32 lib Setarile corespunzatoare pentru aceasta operatie sunt urmatoarele: * Se selecteaza optiunea Settings din meniul Project * In cutia de dialog afisata se selecteaza Link * In zona de editare Object/library modules se adauga cele trei biblioteci de mai sus Rularea unui program OpenGL necesita de asemenea urmatoarele biblioteci cu legare dinamica : opengl32 dll, glu32 dll, glut32 dll In fisierele sursa se va include fisierul header glut h Exemplu 1 Programul din fisierul exemplu11 c afiseaza un dreptunghi centrat în fereastra /* fisierul exemplul1 c */ #include "glut h" /* glut h se afla în directorul curent */ void display(void) { /* sterge toti pixelii */ glClear (GL COLOR BUFFER BIT); /* afiseaza un dreptunghi cu interiorul alb avand colturile în punctele(0 25, 0 25, 0 0) si (0 75, 0 75, 0 0) */ glColor3f (1 0, 1 0, 1 0); glBegin(GL POLYGON); glVertex3f (0 25, 0 25, 0 0); glVertex3f (0 75, 0 25, 0 0); glVertex3f (0 75, 0 75, 0 0); glVertex3f (0 25, 0 75, 0 0); glEnd(); glFlush (); } void init (void) { /* selecteaza culoarea de fond */ glClearColor (0 0, 0 0, 0 0, 0 0); /* initializeaza transformarea de vizualizare */ glMatrixMode(GL PROJECTION); glLoadIdentity(); glOrtho(0 0, 1 0, 0 0, 1 0, -1 0, 1 0); } /* * declara dimensiunea initiala a ferestrei, pozitia si modul de afisare (buffer singular si RGBA) * Deschide o fereastra cu titlul "hello" * Apeleaza rutinele de initializare * Înregistreaza functia callback de refacere a ferestrei * Se intra în bucla principala si se proceseaza evenimentele */ int main(int argc, char** argv) { glutInit(&argc, argv); glutInitDisplayMode (GLUT SINGLE | GLUT RGB); glutInitWindowSize (250, 250); glutInitWindowPosition (100, 100); glutCreateWindow ("hello"); init (); glutDisplayFunc(display); glutMainLoop(); return 0; } Exemplu 2 Programul din fisierul exemplu2 c trateaza evenimentele de la mouse Se afiseaza un dreptunghi centrat în fereastra de afisare La apasarea butonului stânga al mouse-ul dreptunghiul va fi rotit pâna la apasarea butonului drept al mouse-ului /* fisierul exemplul2 c */ #include "glut h" /* glut h se afla în directorul curent */ #include static GLfloat spin = 0 0; void init(void) { glClearColor (0 0, 0 0, 0 0, 0 0); } void display(void) { glClear(GL COLOR BUFFER BIT); glPushMatrix(); glRotatef(spin, 0 0, 0 0, 1 0); glColor3f(1 0, 1 0, 1 0); glRectf(-25 0, -25 0, 25 0, 25 0); glPopMatrix(); glutSwapBuffers(); } void spinDisplay(void) { spin = spin + 2 0; if (spin > 360 0) spin = spin - 360 0; glutPostRedisplay(); } void reshape(int w, int h) { glViewport (0, 0, (GLsizei) w, (GLsizei) h); glMatrixMode(GL PROJECTION); glLoadIdentity(); glOrtho(-50 0, 50 0, -50 0, 50 0, -1 0, 1 0); glMatrixMode(GL MODELVIEW); glLoadIdentity(); } void mouse(int button, int state, int x, int y) { switch (button) { case GLUT LEFT BUTTON: if (state == GLUT DOWN) glutIdleFunc(spinDisplay); break; case GLUT RIGHT BUTTON: if (state == GLUT DOWN) glutIdleFunc(NULL); break; default: break; } } int main(int argc, char** argv) { glutInit(&argc, argv); glutInitDisplayMode (GLUT DOUBLE | GLUT RGB); glutInitWindowSize (250, 250); glutInitWindowPosition (100, 100); glutCreateWindow (argv ); init (); glutDisplayFunc(display); glutReshapeFunc(reshape); glutMouseFunc(mouse); glutMainLoop(); return 0; } II 5 Afisarea obiectelor 3D predefinite GLUT contine functii pentru afisarea urmatoarelor obiecte 3D: con icosaedru teapot cub octaedru tetraedru dodecaedru sfera tor Aceste obiecte pot fi afisate prin familii de curbe sau ca obiecte solide Exemplu: functii de desenare cub, sfera si tor prin doua familii de curbe si ca solide Desenare cub de latura size prin doua familii de curbe void glutWireCube(GLdouble size); Desenare cub solid de latura size void glutSolidCube(GLdouble size); Desenare sfera prin doua familii de curbe void glutWireSphere(GLdouble radius, GLint slices, GLint stacks); Desenare sfera solida void glutSolidSphere(GLdouble radius, GLint slices, GLint stacks); Desenare tor prin doua familii de curbe void glutWireTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); Desenare tor solid void glutSolidTorus(GLdouble innerRadius, GLdouble outerRadius, GLint nsides, GLint rings); Alte functii sunt: void glutWireIcosahedron(void); void glutSolidIcosahedron(void); void glutWireOctahedron(void); void glutSolidOctahedron(void); void glutWireTetrahedron(void); void glutSolidTetrahedron(void); void glutWireDodecahedron(GLdouble radius); void glutSolidDodecahedron(GLdouble radius); void glutWireCone( GLdouble radius, GLdouble height, GLint slices,GLint stacks); void glutSolidCone(GLdouble radius, GLdouble height, GLint slices,GLint stacks); void glutWireTeapot(GLdouble size); void glutSolidTeapot(GLdouble size); Toate aceste obiecte sunt desenate centrate în originea sistemului de coordonate real În momentul în care se fac modificari asupra unui obiect complex poate apare efectul de "pâlpâire" a imaginii Pentru evitarea acestui efect se asociaza ferestrei aplicatiei un buffer dublu Astfel, într-un buffer se pastreaza imaginea nemodificata (imaginea ce este afisata pe ecran), iar în cel de-al doilea se construieste imaginea modificata În momentul în care s-a terminat construirea imaginii modificate se interschimba buffer-ele (lucrul cu doua buffere este asemanator lucrului cu mai multe pagini video în DOS) Pentru interschimbarea bufferelor se foloseste functia: glutSwapBuffers : void glutSwapBuffers(void) ; II 6 Specificarea culorilor II 6 1 Culoarea de desenare Într-un program OpenGL mai întai trebuie setata culoarea de desenare si apoi se face desenarea efectiva a obiectelor Cât timp culoarea de desenare nu se modifica, toate obiectele vor fi desenate cu acea culoare Exemplu: set current color(red); draw object(A); draw object(B); set current color(green); set current color(blue); draw object(C); La executia secventei din exemplu, obiectele A si B vor fi desenate cu rosu iar obiectul C cu albastru Comanda set current color(green) nu are nici un efect Pentru a seta o culoare de desenare se poate apela functia glColor3f : void glColor3f(GLfloat red, GLfloat green, GLfloat blue) ; Parametrii functiei specifica componentele rosu, verde si albastru ale culorii ce va fi setata Ei au valori în intervalul Exemple: glColor3f(0 0, 0 0, 0 0); /* negru */ glColor3f(1 0, 0 0, 0 0); /* rosu */ glColor3f(0 0, 1 0, 0 0); /* verde */ glColor3f(1 0, 1 0, 0 0); /* galben */ glColor3f(0 0, 0 0, 1 0); /* albastru */ glColor3f(1 0, 0 0, 1 0); /* magenta */ glColor3f(0 0, 1 0, 1 0); /* cyan */ glColor3f(1 0, 1 0, 1 0); /* alb */ Alte modalitati de specificare a culorilor sunt prezentate în capitolul II 10 II 6 2 Stergerea ferestrei Stergerea fondului ferestrei este necesar sa fie efectuata înaintea începerii creerii unei noi imagini Exemplu Se afiseaza toti pixelii ferestrei în culoarea negru glClearColor(0 0, 0 0, 0 0, 0 0); glClear(GL COLOR BUFFER BIT); Prima comanda seteaza culoarea de stergere negru si comanda urmatoare sterge întreaga fereastra folosind culoarea curenta de stergere Parametrul functiei glClear indica bufferul care va fi sters De obicei se seteaza o singura data culoarea de stergere la începutul aplicatiei si apoi se apeleaza functia de stergere de câte ori este necesar void glClearColor( GLclampf red, GLclampf green, GLclampf blue, GLclampf alpha); Valorile red, green, blue sunt în intervalul Culoarea implicita de stergere este (0, 0, 0, 0) - negru Parametrul alpha specifica opacitatea; valoarea sa implicita este 0 0 void glClear(GLbitfield mask); Functia seteaza bufferul indicat prin parametrul mask la valoarea specificata Valorile posibile ale parametrului mask sunt prezentate în tabelul II 2: Mask Buffer-ul ce va fi sters GL COLOR BUFFER BIT Buffer-ul curent pentru setarea culorii de desenare GL DEPTH BUFFER BIT Buffer-ul de adancime Tabelul II 2 II 7 Definirea primitivelor geometrice Orice primitiva geometrica este definita printr-o secventa de puncte 3D numite vârfuri Fiecare vârf este reprezentat intern prin cele 3 coordonate (x, y, z) Pentru vârfurile specificate de programator în 2D, sistemul asigneaza coordonatei z valoarea 0 În OpenGL, linia înseamna segment de dreapta Poligoanele sunt suprafete marginite de un contur poligonal închis format din segmente de dreapta Segmentele de dreapta sunt specificate prin vârfurile capetelor segmentelor OpenGL impune câteva restrictii asupra poligoanelor (figura II 1): laturile poligoanelor nu se pot intersecta (poligoane simple) si poligoanele trebuie sa fie convexe Nu pot fi descrise poligoane cu treceri interioare (ele nu sunt convexe) Figura II 1 Poligoane valide si nevalide Deoarece în OpenGL vârfurile sunt întotdeauna puncte 3D, punctele ce formeaza frontiera unui poligon nu este necesar sa fie coplanare Daca vârfurile unui poligon nu sunt coplanare, atunci dupa rotatii, modificarea pozitiei observatorului si proiectia în ecran, punctele pot sa nu mai formeze un poligon convex simplu Problema din figura II 2 poate fi evitata prin folosirea triunghiurilor, deoarece orice trei puncte sunt coplanare Figura II 2 II 7 1 Definirea vârfurilor În OpenGL toate primitivele geometrice sunt definite prin multimi ordonate de vârfuri Pentru a specifica un vârf se foloseste functia: void glVertex{234}{sifd}[v](TYPE coords); Functia poate avea: * 2 parametri - vârful va fi specificat în 2D prin coordonatele sale (x, y) * 3 parametri - vârful va fi specificat în 3D prin coordonatele sale (x, y, z) * 4 parametri - vârful va fi specificat în 3D prin coordonatele sale omogene (x, y, z, w) Si în acest caz TYPE reprezinta tipul coordonatelor vârfului (s - short, i - int , f - float, d - double) Apelul functiei glVertex trebuie sa fie facut între perechea de comenzi glBegin si glEnd Exemplu Modalitati de definire a vârfurilor: glVertex2s(2, 3); glVertex3d(0 0, 0 0, 3 1415926535898); glVertex4f(2 3, 1 0, -2 2, 2 0); GLdouble dvect = {5 0, 9 0, 1992 0}; glVertex3dv(dvect); II 7 2 Puncte, linii si poligoane Pentru a crea o multime de puncte, o linie sau un poligon pornind de la vârfuri, fiecare set de vârfuri trebuie sa fie apelat între comenzile glBegin si glEnd Argumentul functiei glBegin determina tipul primitivei ce va fi afisata : void glBegin(GLenum mode); Parametrul mode poate avea una din valorile (figura II 3): * GL POINTS * GL LINES * GL POLYGON * GL TRIANGLES * GL QUADS * GL LINE STRIP * GL LINE LOOP * GL TRIANGLE STRIP * GL TRIANGLE FAN * GL QUAD STRIP Figura II 3 Tipurile de primitive geometrice definite în OpenGL GL LINES specifica afisarea mai multor segmente de dreapta, câte unul pentru fiecare pereche de vârfuri Vârfurile sunt conectate în ordinea v0 - v1, v2 - v3, v4 - v5 etc Daca este dat un numar impar de vârfuri, ultimul vârf este ignorat GL LINE STRIP specifica o polilinie de la vârful v0 la varful vn, conectând vârfurile în ordinea data; GL LINE LOOP specifica un poligon, vârfurile fiind unite în ordinea data; ultimul vârf este conectat cu primul GL POLYGON specifica un poligon de la vârful v0 la vârful vn-1 (n trebuie sa fie cel putin 3) Poligonul trebuie sa fie un poligon convex simplu Pentru poligoanele concave rezultatul afisarii este nedefinit De asemenea, vârfurile trebuie sa fie situate în acelasi plan; GL QUADS specifica o serie de patrulatere separate Primul patrulater este desenat folosind vârfurile v0, v1, v2 si v3, urmatorul v4, v5, v6 si v7 etc Daca n nu este multiplu de 4 vârfurile suplimentare sunt ignorate; GL TRIANGLES specifica o serie de triunghiuri separate; GL QUAD STRIP specifica o serie de patrulatere conectate Primul patrulater este desenat folosind vârfurile v0, v1, v2 si v3, Urmatorul refoloseste ultimele doua vârfuri v2, v3 si foloseste urmatoarele doua în ordinea v5 si v6 Fiecare patrulater foloseste ultimele doua vârfuri de la patrulaterul anterior În fiecare caz n trebuie sa fie cel putin 4 si multiplu de 2; GL TRIANGLE STRIP specifica o serie de triunghiuri conectate Primul triunghi foloseste vârfurile v0, v1 si v2 Urmatorul v2, v1 si v3, urmatorul v2, v3 si v4 Se observa ca ordinea asigura ca toate triunghiurile sa fie orientate la fel; GL TRIANGLE FAN specifica o serie de triunghiuri conectate într-un vârf comun, vârful v0 Primul triunghi este desenat folosind vârfurile v0, v1 si v2, urmatorul foloseste v0, v2 si v3, urmatorul v0, v3 si v4 etc Functia glEnd marcheaza sfârsitul listei de vârfuri void glEnd(void); Exemplu: Primitiva redata în figura II 4 este specificata prin urmatoarea secventa : glBegin(GL POLYGON); glVertex2f(0 0, 0 0); glVertex2f(0 0, 3 0); glVertex2f(3 0, 3 0); glVertex2f(4 0, 1 5); glVertex2f(3 0, 0 0); glEnd(); Daca se foloseste GL POINTS în loc de GL POLYGON, primitiva va fi formata din 5 puncte Figura II 4 Restrictii de folosire pentru glBegin si glEnd Coordonatele vârfurilor se specifica folosind functia glVertex* Pentru un vârf pot fi furnizate informatii suplimentare, cum ar fi: culoarea, vectorul normala, etc In tabelul II 3 sunt specificate functiile care pot fi apelate între glBegin si glEnd : Functia Comentarii glVertex* Stabileste coordonatele vârfului glColor* Stabileste culoarea curenta a vârfului glIndex* Seteaza indexul curent de culoare glNormal* Stabileste vectorul normala glEvalCoord* Genereaza coordonatele glCallList, glCallLists Executa lista (listele) de afisare glTexCoord* Seteaza coordonatele de texturare glEdgeFlag* controloleaza desenarea muchiilor glMaterial* Stabileste proprietatile de material Tabelul II 3 Functii care pot fi apelate între glBegin si glEnd Daca între apelurile functiilor glBegin si glEnd apar apelurile altor functii GLUT se va genera cod de eroare Pot apare însa instructiuni ale limbajului de programare în care este implementata aplicatia Exemplu Desenarea unui cerc prin linii #define PI 3 1415926535897; GLint circle points = 100; glBegin(GL LINE LOOP); for (i = 0; i pozitionând obiectul în fata unei camere de luat vederi fixe > pozitionând camera de luat vederi în fata obiectului fix Prima operatie corespunde unei transformari de modelare a obiectului Cea de a doua operatie corespunde unei transformari de vizualizare Deoarece ambele pot fi folosite pentru a obtine o aceeasi imagine, sunt tratate împreuna, ca o singura transformare Transformarea de modelare are drept scop pozitionarea obiectelor în scena 3D Aceasta transformare este necesara deoarece, în mod uzual, fiecare obiect este definit ca obiect unitate într-un sistem de coordonate local De exemplu, un cub poate fi definit ca având latura de o unitate, centrat în originea unui sistem de coordonate carteziene 3D Reprezentarea la marimea dorita, pozitionarea si orientarea sa în scena 3D, care este definita într-un sistem de coordonate global, poate sa presupuna o transformare compusa din scalare si rotatie fata de originea sistemului de coordonate local, urmata de o translatie Prin aceasta transformare se creaza o instanta a cubului, de aceea transformarea de modelare se mai numeste si transformare de instantiere Transformarea de modelare este o transformare compusa din transformari geometrice simple care poate fi definita ca produs matricial, folosind functiile de translatie, rotatie si scalare oferite de OpenGL Transformarea de vizualizare este determinata de pozitia observatorului (camera de luat vederi), directia în care priveste acesta si directia sus a planului de vizualizare In mod implicit, observatorul este situat in originea sistemului de coordonate în care este descrisa scena 3D, directia în care priveste este directia negativa al axei OZ, iar directia sus a planului de vizualizare este directia pozitiva a axei OY Cu aceste valori implicite, transformarea de vizualizare este transformarea identica Functia gluLookAt permite modificarea parametrilor impliciti ai transformarii de vizualizare : void gluLookAt(GLdouble eyex,GLdouble eyey,GLdouble eyez, GLdouble centerx,GLdouble centery,GLdouble centerz, GLdouble upx,GLdouble upy,GLdouble upz); - eyex, eyey, eyez reprezinta pozitia observatorului - centerx, centery, centerz reprezinta directa în care se priveste - upx, upy, upz reprezinta directia vectorului " sus " al planului de vizualizare Pozitia observatorului reprezinta punctul de referinta al vederii, R, iar directia în care se priveste este directia normalei la planul de vizualizare, în R Vectorul " sus " determina directia pozitiva a axei verticale a sistemului de coordonate 2D atasat planului de vizualizare Sistemul de coordonate 2D atasat planului de vizualizare împreuna cu normala la plan formeaza sistemul de coordonate 3D al planului de vizualizare, care în terminologia OpenGL este numit sistemul de coordonate observator Functia gluLookAt construieste matricea transformarii din sistemul de coordonate obiect în sistemul de coordonate observator si o înmulteste la dreapta cu matricea curenta In OpenGL transformarea de modelare si de vizualizare sunt exprimate printr-o singura matrice de transformare, care se obtine înmultind matricile celor doua transformari Ordinea de înmultire a celor doua matrici trebuie sa corespunda ordinei în care ar trebui aplicate cele doua transformari : mai întâi transformarea de modelare apoi transformarea de vizualizare In OpenGL punctele 3D se reprezinta prin vectori coloana Astfel, un punct (x,y,z) se reprezinta în coordonate omogene prin vectorul [xw yw zw w]T Daca A, B si C sunt 3 matrici de transformare care exprima transformarile de aplicat punctului în ordinea A, B, C, atunci secventa de transformari se exprima matricial astfel : [xw' yw' zw' w'] T= C •B •A• [xw yw zw w]T Transformarea de modelare si vizualizare este o transformare compusa, reprezentata printr-o matrice VM, ce se obtine înmultind matricea transformarii de vizualizare cu matricea transformarii de modelare Fie V si M aceste matrici Atunci, VM = V•M Daca coordonatele unui vârf în sistemul de coordonate obiect sunt reprezentate prin vectorul [xo yo zo wo]T, atunci coordonatele vârfului în sistemul de coordonate observator ("eye coordinates") se obtin astfel: [xe ye ze we]T = VM • [xo yo zo wo]T Matricea VM este aplicata automat si vectorilor normali II 9 3 Transformarea de proiectie Matricea de proiectie este calculata în OpenGL în functie de tipul de proiectie specificat de programator si parametrii care definesc volumul de vizualizare Matricea de proiectie este matricea care transforma volumul vizual definit de programator într-un volum vizual canonic Aceasta transformare este aplicata vârfurilor care definesc primitivele geometrice în coordonate observator, rezultând coordonate normalizate Primitivele reprezentate prin coordonate normalizate sunt apoi decupate la marginile volumului vizual canonic, de aceea coordonatele normalizate se mai numesc si coordonate de decupare Volumul vizual canonic este un cub cu latura de 2 unitati, centrat în originea sistemului coordonatelor de decupare Dupa aplicarea transformarii de proiectie, orice punct 3D (din volumul vizual canonic) se proiecteaza în fereastra 2D printr-o proiectie ortografica (x' =x, y'=y) conditie necesara pentru aplicarea algoritmului z-buffer la producerea imaginii Daca coordonatele unui vârf în sistemul de coordonate observator sunt reprezentate prin vectorul [xe ye ze we]T, iar P este matricea de proiectie, atunci coordonatele de decupare ale vârfului ("clip coordinates") se obtin astfel: [xc yc zc wc]T = P • [xo yo zo wo]T Prezentam în continuare functiile OpenGL prin care pot fi definite proiectiile si volumul de vizualizare void glFrustum(GLdouble left, GLdouble right, GLdouble bottom, GLdouble top, GLdouble near, GLdouble far); Functia defineste o proiectie perspectiva cu centrul de proiectie în pozitia observatorului (punctul de referinta al vederii) Volumul de vizualizare (figura II 9) este delimitat prin " planul din fata " si " planul din spate ", plane paralele cu planul de vizualizare, definite prin distantele lor fata de pozitia observatorului (planul de vizualizare) Planul din fata va fi folosit ca plan de proiectie Lui i se ataseaza un sistem de coordonate 2D având axa verticala (sus) orientata ca si axa verticala a planului de vizualizare Deschiderea camerei de luat vederi este determinata printr-o fereastra rectangulara, cu laturile paralele cu axele, definita în planul de proiectie - (left, bottom) si (right, top) reprezinta colturile ferestrei din planul din fata - znear, zfar reprezinta distantele de la pozitia observatorului la planul din fata, respectiv spate Ambele distante trebuie sa fie pozitive Figura II 9 Volumul vizual perspectiva Daca left=right sau bottom=top sau znear=zfar sau znear Stiva matricilor Modelview (cel putin 32 matrici 4 x 4); > Stiva matricilor de proiectie (cel putin 2 matrici 4 x 4) ; > Stiva matricilor textura(cel putin 2 matrici 4 x 4) Matricea curenta este întotdeauna matricea din vârful stivei corespunzatoare modului matrice curent O stiva de matrici este folositoare pentru construirea modelelor ierarhice în care sunt construite obiecte complexe pornind de la obiecte simple De exemplu, sa presupunem ca se deseneaza o masina si exista o singura rutina care deseneaza o roata Aceasta rutina deseneaza roata într-o anumita pozitie si orientare Când se deseneaza masina, rutina de afisare a rotii se va apela de 4 ori, aplicându-se diferite transformari pentru a pozitiona corect rotile De exemplu, pentru desenarea primei roti aceasta trebuie sa fie translatata La desenarea celei de a doua roti trebuie aplicata o alta translatie (dar fata de pozitia initiala - nu trebuie tinut cont de prima translatie) si în acelasi mod pentru desenarea celorlalte roti Deoarece transformarile sunt pastrate ca matrici, o stiva de matrici furnizeaza un mecanism util pentru efectuarea unei transformari ca apoi sa se realizeze o alta transformare fara a se mai tine cont de transformarea anterioara Toate operatiile cu matrici (glLoadMatrix, glMultMatrix, glLoadIdentity si functiile care creeaza matrici de transformare specifice) lucreaza cu matricea curenta sau cu matricea din vârful stivei Pentru lucrul cu stivele de matrici OpenGL pune la dispozitie functiile glPushMatrix si glPopMatrix void glPushMatrix(void); Functia adauga un nou element la stiva curenta si memoreaza matricea curenta atât în elementul din vârful stivei cât si în intrarea urmatoare Stiva curenta este determinata de ultimul apel al functiei glMatrixMode Daca prin adaugare se depaseste capacitatea stivei se genereaza eroare void glPopMatrix(void); Functia elimina intrarea din vârful stivei si înlocuieste matricea curenta cu matricea care era memorata în a 2-a intrare a stivei Daca stiva avea o singura intrare, apelul functiei glPopMatrix genereaza eroare Exemplu Programul din fisierul exemplu5 c afiseaza un cub care este mai întâi scalat (transformarea de modelare) Transformarea de vizualizare consta dintr-o translatie a pozitiei observatorului pe axa z, în pozitia (0,0,5) Observatorul priveste spre origine iar directia axei sus este directia axei OY a sistemului de coordonate obiect /* exemplu5 c */ #include "glut h" void init(void) { glClearColor (0 0, 0 0, 0 0, 0 0); } void display(void) { glClear (GL COLOR BUFFER BIT); glColor3f (1 0, 1 0, 1 0); glLoadIdentity (); gluLookAt(0 0,0 0,5 0,0 0,0 0,0 0,0 0,1 0,0 0); glScalef (1 0, 2 0, 1 0); glutWireCube (1 0); glFlush (); } void reshape (int w, int h) { glViewport (0, 0, (GLsizei) w, (GLsizei) h); glMatrixMode (GL PROJECTION); glLoadIdentity (); glFrustum (-1 0, 1 0, -1 0, 1 0, 1 5, 20 0); glMatrixMode (GL MODELVIEW); } int main(int argc, char** argv) { glutInit(&argc, argv); glutInitDisplayMode (GLUT SINGLE | GLUT RGB); glutInitWindowSize (500, 500); glutInitWindowPosition (100, 100); glutCreateWindow (argv ); init (); glutDisplayFunc(display); glutReshapeFunc(reshape); glutMainLoop(); return 0; } Transformarea de vizualizare si modelare este creata în functia display unde este apelata si functia de afisare a cubului, glutWireCube Astfel functia display poate fi folosita în mod repetat pentru a afisa continutul ferestrei (de exemplu în cazul în care fereastra este mutata pe ecran) Transformarea de proiectie si transformarea în poarta de vizualizare sunt specificate în functia Reshape, care este apelata de sistem ori de câte ori este redimensionata fereastra aplicatiei Efectul obtinut prin mutarea observatorului în spatele cubului (folosind transformarea de vizualizare) se poate obtine si prin deplasarea cubului, folosind o transformare de modelare II 10 Iluminarea II 10 1 Specificarea culorilor pentru lumina si materiale In capitolul II 6 ne-am referit la modul uzual în care sunt specificate culorile de afisare a obiectelor Functiile glColor3 specifica un triplet (R, G, B) Functiile glColor4 adauga tripletului (R,G,B) o valoare de opacitate, numita valoarea alfa (A) OpenGL permite utilizarea a doua moduri de reprezentare a culorilor de afisare: > modul RGBA: pentru fiecare pixel se memoreaza valorile R, G, B si A > modul indexat: pentru fiecare pixel se memoreaza un numar, reprezentând un index într-o tabela de culori Valorile R, G, B si A variaza în domeniul În modul RGBA, pentru selectarea culorii curente de desenare se folosesc functiile glColor* void glColor3{b s i f d ub us ui} (TYPE r, TYPE g, TYPE b); void glColor4{b s i f d ub us ui} (TYPE r, TYPE g, TYPE b, TYPE a); void glColor3{b s i f d ub us ui}v (const TYPE* v); void glColor4{b s i f d ub us ui}v (const TYPE* v); Valoarea implicita a opacitatii este 1 0 Pentru versiunile functiei glColor* care accepta valori de tip real, domeniul acestora trebuie sa fie în intervalul Valorile din afara intervalului sunt trunchiate la valori în intervalul când sunt folosite ca parametri directi, dar nu sunt trunchiate daca sunt folosite pentru a modifica parametrii de material si iluminare Valorile parametrilor de culoare specificate prin numere întregi sunt convertite în valori reale, conform tabelulului II 4 Tip Valoarea minima Valoarea minima se mapeaza la Valoarea maxima Valoarea maxima se mapeaza la b 1-byte integer -128 -1 0 127 1 0 s 2-byte integer -32,768 -1 0 32,767 1 0 i 4-byte integer -2,147,483,648 -1 0 2,147,483,647 1 0 ub unsigned 1-byte integer 0 0 0 255 1 0 us unsigned 2-byte integer 0 0 0 65,535 1 0 ui unsigned 4-byte integer 0 0 0 4,294,967,295 1 0 Tabelul II 4 Conversia valorilor de culoare la numere reale Componentele culorilor specificate prin functiile glColor* au semnificatii diferite dupa cum sunt folosite pentru lumisa emisa de o sursa sau lumina reflectata de o suprafata Pentru o sursa de lumina, valorile componentelor R, G si B corespund unui procent din intensitatea maxima pentru fiecare culoare Daca valorile R, G si B sunt 1 0 atunci lumina este alb stralucitor Daca valorile sunt 0 5, culoarea este alba, iar la jumatate din intensitate apare gri Daca R=G=1 si B=0 lumina apare galbena Pentru proprietatile de material, valorile componentelor R, G si B corespund proportiilor reflectate din acea culoare Daca R=1, G=0 5 si B=0 pentru un material, atunci acel material va reflecta toata lumina incidenta rosie, jumatate din lumina incidenta verde si nimic din lumina incidenta albastra Cu alte cuvinte daca o sursa de lumina are componentele (LR, LG, LB) si un material are componentele corespunzatoare (MR, MG, MB) atunci ignorându-se toate celelalte efecte ale reflectivitatii, lumina ce este perceputa de ochiul observatorului este data de formula (LR*MR, LG*MG, LB*MB) Analog daca sunt doua surse de lumina, cu componentele (R1, G1, B1) si (R2, G2, B2), atunci lumina rezultata va fi data de (R1+R2, G1+G2, B1+B2) Daca oricare dintre componentele rezultate sunt mai mari ca 1, atunci componenta respectiva va fi trunchiata la 1 II 10 2 Specificarea modelului de iluminare Modelele de iluminare care pot fi folosite în OpenGL sunt modelul Lambert si modelul Gouraud Modelul de iluminare dorit se specifica cu ajutorul functiei glShadeModel void glShadeModel (GLenum mode); - mode specifica modelul de iluminare ce va fi selectat; el poate avea valorile: > GL SMOOTH: este valoarea implicita, prin care se selecteaza modelul Gouraud > GL FLAT : selecteaza modelul Lambert În modelul Gouraud culoarea fiecarui vârf este tratata în mod individual Pentru un segment de dreapta culoarea se obtine prin interpolarea culorilor vârfului Pentru un poligon, culorile punctelor interioare se obtin prin interpolare pe baza culorilor vârfurilor Exemplu : în fisierul exemplul6 c se afiseaza un triunghi folosind modelul de iluminare Gouraud /* fisierul exemplul6 c */ #include "glut h" void init(void) { glClearColor (0 0, 0 0, 0 0, 0 0); glShadeModel (GL SMOOTH); } void triangle(void) { glBegin (GL TRIANGLES); glColor3f (1 0, 0 0, 0 0); glVertex2f (5 0, 5 0); glColor3f (0 0, 1 0, 0 0); glVertex2f (25 0, 5 0); glColor3f (0 0, 0 0, 1 0); glVertex2f (5 0, 25 0); glEnd(); } void display(void) { glClear (GL COLOR BUFFER BIT); triangle (); glFlush (); } void reshape (int w, int h) { glViewport (0, 0, (GLsizei) w, (GLsizei) h); glMatrixMode (GL PROJECTION); glLoadIdentity (); if (w #include #include #define M PI 3 14 GLuint theTorus; /* afisare tor */ void torus(int numc, int numt) { int i, j, k; double s, t, x, y, z, twopi; twopi = 2 * (double)M PI; for (i = 0; i = 0; k ) { s = (i + k) % numc + 0 5; t = j % numt; x = (1+ 1*cos(s*twopi/numc))*cos(t*twopi/numt); y = (1+ 1*cos(s*twopi/numc))*sin(t*twopi/numt); z = 1 * sin(s * twopi / numc); glVertex3f(x, y, z); } } glEnd(); } } /* creeaza lista de afisare pentru tor */ void init(void) { theTorus = glGenLists (1); glNewList(theTorus, GL COMPILE); torus(8, 25); glEndList(); glShadeModel(GL FLAT); glClearColor(0 0, 0 0, 0 0, 0 0); } void display(void) { glClear(GL COLOR BUFFER BIT); glColor3f (1 0, 1 0, 1 0); glCallList(theTorus); glFlush(); } void reshape(int w, int h) { glViewport(0, 0, (GLsizei) w, (GLsizei) h); glMatrixMode(GL PROJECTION); glLoadIdentity(); gluPerspective(30, (GLfloat) w/(GLfloat) h, 1 0, 100 0); glMatrixMode(GL MODELVIEW); glLoadIdentity(); gluLookAt(0, 0, 10, 0, 0, 0, 0, 1, 0); } /* la apasarea tastei 'x' - se roteste în jurul axei x la apasarea tastei 'y' - se roteste în jurul axei y la apasarea tastei 'i' - se pozitioneaza torul în pozitia originala */ void keyboard(unsigned char key, int x, int y) { switch (key) { case 'x': case 'X': glRotatef(30 ,1 0,0 0,0 0); glutPostRedisplay(); break; case 'y': case 'Y': glRotatef(30 ,0 0,1 0,0 0); glutPostRedisplay(); break; case 'i': case 'I': glLoadIdentity(); gluLookAt(0, 0, 10, 0, 0, 0, 0, 1, 0); glutPostRedisplay(); break; case 27: exit(0); break; } } int main(int argc, char **argv) { glutInitWindowSize(200, 200); glutInit(&argc, argv); glutInitDisplayMode(GLUT SINGLE | GLUT RGB); glutCreateWindow(argv ); init(); glutReshapeFunc(reshape); glutKeyboardFunc(keyboard); glutDisplayFunc(display); glutMainLoop(); return 0; } Utilizatorul poate roti torul în jurul axei OX sau OY prin apasarea tastelor x respectiv y De câte ori se întampla acest lucru este apelata functia callback keyboard care înmulteste matricea de rotatie de 30o în jurul axei x sau y cu matricea curenta ModelView, dupa care este apelata functia glutPostRedisplay, care face ca functia glutMainLoop sa apeleze functia display si sa afiseze torul dupa prelucrarea altor evenimente La apasarea tastei 'i' functia keyboard reface matricea initiala ModelView si reafiseaza torul în pozitia sa initiala Functia display sterge fereastra si apeleaza functia glCallList pentru a executa comenzile din lista de afisare Daca nu s-ar fi folosit liste de afisare functia display ar fi trebuit sa contina comenzi de desenare a torului de fiecare data când ar fi fost apelata O lista de afisare contine numai comenzi OpenGL În exemplul din fisierul exemplul8 c sunt stocate apelurile functiilor glBegin, glVertex si glEnd Parametrii apelurilor sunt evaluati si valorile lor sunt copiate în lista de afisare la crearea sa Toate calculele trigonometrice pentru crearea torului sunt facute o singura data ceea ce duce la cresterea performantelor afisarii Exemplu: aplicarea unor transformari unor obiecte geometrice si apoi desenarea rezultatului: glNewList(1, GL COMPILE); afiseaza obiectele geometrice(); glEndList(); glLoadMatrix(M); glCallList(1); Daca obiectele sunt transformate de fiecare data în acelasi mod este bine sa se pastreze matricea de transformare într-o lista de afisare Exemplu In unele implementari, se vor putea îmbunatati performantele prin transformarea obiectelor în momentul definirii lor în loc de a le transforma de fiecare data când sunt afisate : glNewList(1, GL COMPILE); glLoadMatrix(M); afiseaza obiectele geometrice(); glEndList(); glCallList(1); Listele de afisare au si dezavantaje Listele foarte mici nu vor îmbunatati executia programului datorita overhead-ului executiei listei Un alt dezavantaj consta din faptul ca o lista de afisare nu poate fi modificata si continutul sau nu poate fi citit Daca aplicatia necesita pastrarea datelor separat fata de lista de afisare atunci va fi necesara memorie suplimentara II 11 2 Crearea si executarea listelor de afisare Functiile glNewList si glEndList sunt folosite pentru delimitarea unei liste de afisare, care este executata prin apelul functiei glCallList având ca parametru identificatorul sau În fisierul exemplul9 c lista de afisare este creata în functia init În functia display lista de afisare va fi apelata de 10 ori Listele de afisare aloca memorie pentru a stoca comenzile si valorile oricarei variabilele necesare Functia glTranslatef din lista de afisare modifica pozitia urmatorului obiect ce va fi afisat Apelul drawLine este de asemenea afectat de functia glTranslatef care o precede /* fisierul exemplul9 c */ #include "glut h" #include GLuint listName; void init (void) { listName = glGenLists (1); glNewList (listName, GL COMPILE); glColor3f (1 0, 0 0, 0 0); /* culoarea curenta rosu */ glBegin (GL TRIANGLES); glVertex2f (0 0, 0 0); glVertex2f (1 0, 0 0); glVertex2f (0 0, 1 0); glEnd (); glTranslatef (1 5, 0 0, 0 0); /* modificare pozitie */ glEndList (); glShadeModel (GL FLAT); } void drawLine (void) { glBegin (GL LINES); glVertex2f (0 0, 0 5); glVertex2f (15 0, 0 5); glEnd (); } void display(void) { GLuint i; glClear (GL COLOR BUFFER BIT); glColor3f (0 0, 1 0, 0 0); /* culoarea curenta verde */ for (i = 0; i < 10; i++) /* afisare 10 triunghiuri */ glCallList (listName); drawLine (); glFlush (); } void reshape(int w, int h) { glViewport(0, 0, w, h); glMatrixMode(GL PROJECTION); glLoadIdentity(); if (w <= h) gluOrtho2D (0 0, 2 0, -0 5 * (GLfloat) h/(GLfloat) w, 1 5 * (GLfloat) h/(GLfloat) w); else gluOrtho2D (0 0, 2 0*(GLfloat) w/(GLfloat) h, -0 5, 1 5); glMatrixMode(GL MODELVIEW); glLoadIdentity(); } void keyboard(unsigned char key, int x, int y) { switch (key) { case 27: exit(0); } } int main(int argc, char** argv) { glutInit(&argc, argv); glutInitDisplayMode (GLUT SINGLE | GLUT RGB); glutInitWindowSize(650, 50); glutCreateWindow(argv ); init (); glutReshapeFunc (reshape); glutKeyboardFunc (keyboard); glutDisplayFunc (display); glutMainLoop(); return 0; } Observatie: Daca o lista de afisare contine comenzi de transformare trebuie avut grija care va fi efectul acestora în program mai târziu La un moment dat poate fi creata numai o singura lista de afisare Cu alte cuvinte trebuie terminata crearea unei liste de afisare (glNewList si glEndList) înainte de a crea o alta lista Apelul functiei glEndList fara a fi apelat înainte functia glNewList va genera eroarea GL INVALID OPERATION II 11 2 1 Crearea unei liste de afisare Fiecare lista de afisare este identificata printr-un index întreg La crearea unei liste de afisare trebuie sa se aiba grija sa nu se aleaga un index care este deja folosit, altfel se va sterge lista de afisare existenta Pentru evitarea acestui lucru se va folosi functia glGenLists ce va genera unul sau mai multi indici nefolositi : GLuint glGenLists(GLsizei range); Functia aloca un domeniu de range numere continue nefolosite ca indici pentru liste de afisare Valoarea întoarsa de functie reprezinta indicele de început a blocului de indici nefolositi Indicii returnati vor fi marcati ca folositi astfel ca apelurile ulterioare ale functiei glGenLists nu vor întoarce acesti indici pâna nu vor fi stersi Functia întoarce 0 daca nu este disponibil numarul de indici ceruti sau daca range este 0 Exemplu: alocarea unui singur index; daca el este liber va fi folosit pentru a crea o noua lista de afisare : listIndex = glGenLists(1); if (listIndex != 0) { glNewList(listIndex,GL COMPILE); glEndList(); } Observatie: Indexul 0 nu reprezinta un index valid pentru lista de afisare void glNewList (GLuint list, GLenum mode); Functia specifica începerea unei liste de afisare Functiile OpenGL care vor fi apelate (pâna la întâlnirea functiei glEndList care marcheaza sfârsitul listei de afisare) sunt stocate în lista de afisare, exceptie facând câteva functii OpenGL care nu pot fi stocate Aceste functii restrictionate sunt executate imediat în timpul crearii listei de afisare - list este un întreg pozitiv diferit de 0 care identifica în mod unic lista de afisare - valorile posibile ale parametrului mode sunt GL COMPILE si GL COMPILE AND EXECUTE Se foloseste valoarea GL COMPILE daca nu se doreste executarea comenzilor OpenGL la plasarea lor în lista de afisare; pentru executia imediata în momentul plasarii în lista de afisare, pentru folosiri ulterioare, se va secifica parametrul GL COMPILE AND EXECUTE void glEndList (void); Functia marcheaza sfârsitul unei liste de afisare La crearea unei liste de afisare ea va fi stocata împreuna cu contextul OenGL curent Astfel, daca contextul va fi distrus, de asemenea lista de afisare va fi distrusa În unele sisteme este posibil ca listele de afisare sa partajeze contexte multiple În acest caz lista de afisare va fi distrusa în momentul în care ultimul context din grup este distrus La crearea unei liste de afisare în ea vor fi stocate doar valorile expresiilor Daca valorile dintr-un vector sunt modificate, valorile din lista de afisare nu vor fi modificate Exemplu Se creaza o lista de afisare ce contine o comanda care seteaza culoarea curenta de afisare negru (0 0, 0 0, 0 0) Modificarea ulterioara a valorii vectorului color vector în rosu (1 0, 0 0, 0 0) nu are nici un efect asupra listei de afisare deoarece aceasta contine valorile de la crearea sa GLfloat color vector = {0 0, 0 0, 0 0}; glNewList(1, GL COMPILE); glColor3fv(color vector); glEndList(); color vector = 1 0; Într-o lista de afisare nu pot fi stocate si executate orice comenzi OpenGL În tabelul II 8 sunt prezentate comenzile care nu pot fi stocate într-o lista de afisare (apelul functiei glNewList în timpul crearii unei liste de afisare genereaza eroare) glColorPointer() glFlush() GlNormalPointer() glDeleteLists() glGenLists() GlPixelStore() glDisableClientState() glGet*() GlReadPixels() glEdgeFlagPointer() glIndexPointer() GlRenderMode() glEnableClientState() glInterleavedArrays() GlSelectBuffer() glFeedbackBuffer() glIsEnabled() GlTexCoordPointer() glFinish() glIsList() GlVertexPointer() Tabelul II 8 La folosirea unui sistem OpenGL în retea, clientul poate rula pe o masina si server-ul pe alta Dupa crearea unei liste de afisare ea se va afla la server astfel ca server-ul nu se poate baza pe client pentru nici o informatie relativa la lista de afisare Astfel, orice comanda care întoarce o valoare nu poate fi stocata într-o lista de afisare În plus, comenzile care modifica starea clientului cum ar fi glPixelStore, glSelectBuffer si comenzile de definire a vectorilor de vârfuri nu pot fi stocate într-o lista de afisare Operatiile unor comenzi OpenGL depind de starea clientului De exemplu, functiile de specificare a vârfurilor vectorilor (cum ar fi glVertexPointer, glColorPointer si glInterleavedArrays) seteaza pointeri de stare ai clientului si nu pot fi stocate într-o lista de afisare Functiile glArrayElement, glDrawArrays si glDrawElements transmit date catre server pentru a construi primitive din elementele vectorilor Astfel de operatii pot fi stocate într-o lista de afisare Vectorul de vârfuri stocat în lista de afisare este obtinut prin dereferentierea datei din pointeri nu prin stocarea pointerilor Astfel, modificarile datelor din vectorul de vârfuri nu va afecta definirea primitivei în lista de afisare Functii cum ar fi glFlush si glFinish nu pot fi stocate într-o lista de afisare deoarece depind de starea clientului în momentul executiei II 11 2 2 Executia unei liste de afisare Dupa crearea unei liste de afisare aceasta poate fi executata prin apelul functiei glCallList O lista de afisare poate fi executata de mai multe ori si de asemenea o lista de afisare poate fi executata îmbinându-se cu apeluri în modul imediat void glCallList (GLuint list); Functia executa lista de afisare specificata de parametrul list Comenzile din lista de afisare sunt executate în ordinea în care au fost salvate ca si cum ar fi executate fara a se folosi o lista de afisare Daca lista nu a fost definita nu se va întâmpla nimic Functia glCallList poate fi apelata din orice punct al programului atâta timp cât contextul OpenGL care acceseaza lista de afisare este activ (contextul care a fost activ la crearea listei de afisare sau un context din acelasi grup partajat) O lista de afisare poate fi creata într-o functie si executata în alta functie atâta timp cât indexul sau o identifica în mod unic De asemenea, contextul unei liste de afisare nu poate fi salvat într-un fisier si nici nu se poate crea o lista de afisare dintr-un fisier În acest sens o lista de afisare este proiectata pentru a fi folosita temporar II 11 3 Liste de afisare ierarhice O lista de afisare ierarhica este o lista de afisare care executa o alta lista de afisare prin apelul functiei glCallList, între perechile de functii glNewList si glEndList O lista de afisare ierarhica este folositoare pentru un obiect alcatuit din componente, în mod special daca aceste componente sunt folosite de mai multe ori Exemplu: o lista de afisare care deseneaza o bicicleta prin apelul altor liste de afisare pentru desenarea componentelor : glNewList(listIndex,GL COMPILE); glCallList(handlebars); glCallList(frame); glTranslatef(1 0,0 0,0 0); glCallList(wheel); glTranslatef(3 0,0 0,0 0); glCallList(wheel); glEndList(); Pentru evitarea recursivitatii infinite limita nivelului de imbricare al listelor de afisare este 64, dar aceasta limita depinde de implementare Pentru a determina limita specifica implementarii OpenGL pe care se lucreaza se apeleaza functia : glGetIntegerv(GL MAX LIST NESTING, GLint *data); OpenGL permite crearea unei liste de afisare care sa apeleze o alta lista de afisare care nu a fost înca creata Nu va avea nici un efect daca prima lista o apeleaza pe cea de a doua care înca nu a fost definita Exemplu : lista de afisare ierarhica glNewList(1,GL COMPILE); glVertex3f(v1); glEndList(); glNewList(2,GL COMPILE); glVertex3f(v2); glEndList(); glNewList(3,GL COMPILE); glVertex3f(v3); glEndList(); glNewList(4,GL COMPILE); glBegin(GL POLYGON); glCallList(1); glCallList(2); glCallList(3); glEnd(); glEndList(); Pentru afisarea poligonului se apeleaza lista de afisare 4 Pentru a edita un vârf este necesar sa se creeze din nou lista de afisare corespunzatoare vârfului respectiv Deoarece un index identifica în mod unic lista de afisare, crearea unei alte liste cu acelasi index o va sterge în mod automat pe cea existenta Trebuie retinut ca aceasta metoda nu foloseste în mod optim memoria si nu îmbunatateste performantele, dar este folositoare în unele cazuri II 11 4 Gestiunea listelor de afisare cu indici Pentru a obtine un indice nefolosit care sa identifice o noua lista de afisare se poate folosi functia glGenLists Daca nu se doreste folosirea acestei functii atunci se poate folosi glIsList pentru a determina daca un anumit index este folosit GLboolean glIsList(GLuint list); Functia întoarce GL TRUE daca indexul specificat de parametrul list este deja folosit pentru o lista de afisare si GL FALSE în caz contrar Pentru a sterge în mod explicit o lista de afisare sau un domeniu continuu de liste se foloseste functia glDeleteLists Folosirea functiei glDeleteLists elibereaza indicii corespunzatori listelor sterse sa fie disponibili din nou void glDeleteLists(GLuint list, GLsizei range); Functia sterge range liste de afisare începând de la indexul specificat de list Este ignorata încercarea de a se sterge o lista de afisare care nu a fost creata II 11 5 Executia listelor de afisare multiple OpenGL furnizeaza un mecanism eficient de a executa succesiv liste de afisare Acest mecanism necesita introducerea indicilor listelor de afisare într-un vector si apoi apelarea functiei glCallLists O utilizare pentru acest mecanism este acela de a crea un font si fiecare indice de lista de afisare sa corespunda valorii ASCII a caracterului din font Pentru a avea mai multe fonturi este necesara stabilirea unui index initial diferit pentru fiecare font Acest index initial poate fi specificat prin apelarea functiei glListBase înainte de a apela glCallLists void glListBase(GLuint base); Functia specifica offset-ul care este adunat indicilor listelor de afisare în apelul functiei glCallLists pentru a obtine indicii listelor de afisare finali Valoarea implicita a parametrului base este 0 Parametrul base nu are nici un efect asupra apelului glCallList, care executa o singura lista de afisare, sau asupra functiei glNewList void glCallLists(GLsizei n, GLenum type, const GLvoid *lists); Functia executa n liste de afisare Indicii listelor care vor fi executate vor fi calculati prin adunarea offset-ului indicat de baza curenta a listei de afisare (specificat cu ajutorul functiei glListBase la valorile întregi indicate de parametrul lists Parametrul type specifica tipul valorilor din lists El poate avea una din valorile GL BYTE, GL UNSIGNED BYTE, GL SHORT, GL UNSIGNED SHORT, GL INT, GL UNSIGNED INT sau GL FLOAT, adica ceea ce indica lists poate fi tratata ca un vector de bytes, unsigned bytes, shorts, unsigned shorts, integers, unsigned integers, sau floats De asemenea parametrul type poate avea una din valorile GL 2 BYTES, GL 3 BYTES sau GL 4 BYTES caz în care succesiuni de 2, 3 sau 4 octeti vor fi cititi din lists si apoi sunt deplasati si adunati octet cu octet pentru a calcula offset-ul listei de afisare Pentru aceasta este folosit urmatorul algoritm (byte reprezinta începutul secventei de octeti) /* b = 2, 3 sau 4; octetii sunt numerotati în vector 0,1,2,3 */ offset = 0; for (i = 0; i < b; i++) { offset = offset << 8; offset += byte[i]; } index = offset + listbase; Exemplu Definirea listelor de afisare multiple: afisarea caracterelor dintr-un set de caractere vectorial void initStrokedFont(void) /* seteaza indicii listelor de afisare pentru fiecare caracter corespunzator valorii lor ASCII */ { GLuint base; base = glGenLists(128); glListBase(base); glNewList(base+'A', GL COMPILE); drawLetter(Adata); glEndList(); glNewList(base+'E', GL COMPILE); drawLetter(Edata); glEndList(); glNewList(base+'P', GL COMPILE); drawLetter(Pdata); glEndList(); glNewList(base+'R', GL COMPILE); drawLetter(Rdata); glEndList(); glNewList(base+'S', GL COMPILE); drawLetter(Sdata); glEndList(); glNewList(base+' ', GL COMPILE); /* spatiu */ glTranslatef(8 0, 0 0, 0 0); glEndList(); } Functia glGenLists aloca 128 de indici continui pentru listele de afisare Primul indice alocat devine baza listei de afisare Pentru fiecare caracter va fi creata câte o lista de afisare; fiecare index al listei de afisare este suma dintre indicele de baza si valoarea ASCII a literei În acest exemplu sunt create numai câteva litere si caracterul ' ' Dupa crearea listelor de afisare poate fi apelata functia glCallLists pentru a le executa Exemplu Apelul functiei printStrokedString având ca parametru un caracter : void printStrokedString(GLbyte *s) { GLint len = strlen(s); glCallLists(len, GL BYTE, s); } II 11 6 Gestiunea variabilelor de stare folosind liste de afisare O lista de afisare poate contine apeluri care sa modifice valorile variabilelor de stare OpenGL Aceste valori se modifica la executia listei de afisare (ca si în modul imediat de executie al comenzilor) si modificarile se pastreaza si dupa executia completa a listei de afisare Exemplu Modificarile culorii curente si a matricii curente facute în timpul executiei listei de afisare ramân vizibile si dupa executarea sa: glNewList(listIndex,GL COMPILE); glColor3f(1 0, 0 0, 0 0); glBegin(GL POLYGON); glVertex2f(0 0,0 0); glVertex2f(1 0,0 0); glVertex2f(0 0,1 0); glEnd(); glTranslatef(1 5,0 0,0 0); glEndList(); Daca se va apela urmatoarea secventa de cod, segmentul de dreapta desenat dupa lista de afisare va avea culoarea rosie (culoarea curenta) si va fi translatat cu (1 5, 0 0, 0 0): glCallList(listIndex); glBegin(GL LINES); glVertex2f(2 0,-1 0); glVertex2f(1 0,0 0); glEnd(); Uneori este necesar ca modificarile starii sa fie pastrate, dar alteori dupa executia unei liste de afisare se doreste sa se revina la starea anterioara Într-o lista de afisare nu poate fi folosita functia glGet*, asa ca trebuie folosit un alt mod de a interoga si stoca valorile variabilelor de stare În acest scop poate fi folosita functia glPushAttrib pentru a salva un grup de variabile de stare si glPopAttrib pentru a reface variabilele Exemplu Refacerea variabilelor de stare din interiorul unei liste de afisare glNewList(listIndex,GL COMPILE); glPushMatrix(); glPushAttrib(GL CURRENT BIT); glColor3f(1 0, 0 0, 0 0); glBegin(GL POLYGON); glVertex2f(0 0,0 0); glVertex2f(1 0,0 0); glVertex2f(0 0,1 0); glEnd(); glTranslatef(1 5,0 0,0 0); glPopAttrib(); glPopMatrix(); glEndList(); Exemplu Daca se foloseste lista de afisare de mai sus atunci se va desena un segment de dreapta de culoare verde si netranslatat: void display(void) { GLint i; glClear(GL COLOR BUFFER BIT); glColor3f(0 0, 1 0, 0 0); /* seteaza culoarea curenta verde */ for (i = 0; i < 10; i++) glCallList(listIndex); /* lista de afisare apelata de 10 ori*/ drawLine(); /* unde si cum apare aceasta linie? */ glFlush(); } II 11 7 Încapsularea schimbarilor de mod Listele de afisare pot fi folosite pentru a organiza si stoca grupuri de comenzi, pentru a modifica diferite moduri sau a seta diferiti parametri Când se doreste comutarea de la un grup de setari la un altul folosirea listelor de afisare poate fi mai eficienta decât apelarea directa Listele de afisare pot fi mai eficiente decât modul imediat pentru comutarea între diferite setari ale surselor de lumina, modelelor de iluminare si parametrilor de material De asemenea, listele de afisare se pot folosi si pentru generarea liniilor cu sablon, precum si pentru ecuatiile planului de decupare În general, executia listelor de afisare este cel putin tot atât de rapida ca si apelul direct dar în cazul folosirii listelor de afisare este introdus un overhead Exemplu Folosirea listelor de afisare pentru a comuta între trei sabloane diferite de linii La început se apeleaza functia glGenLists pentru a aloca o lista de afisare pentru fiecare sablon Apoi se foloseste functia glCallList pentru a comuta între un sablon si altul GLuint offset; offset = glGenLists(3); glNewList (offset, GL COMPILE); glDisable (GL LINE STIPPLE); glEndList (); glNewList (offset+1, GL COMPILE); glEnable (GL LINE STIPPLE); glLineStipple (1, 0x0F0F); glEndList (); glNewList (offset+2, GL COMPILE); glEnable (GL LINE STIPPLE); glLineStipple (1, 0x1111); glEndList (); #define drawOneLine(x1,y1,x2,y2) glBegin(GL LINES); \ glVertex2f ((x1),(y1)); glVertex2f ((x2),(y2)); glEnd(); glCallList (offset); drawOneLine (50 0, 125 0, 350 0, 125 0); glCallList (offset+1); drawOneLine (50 0, 100 0, 350 0, 100 0); glCallList (offset+2); drawOneLine (50 0, 75 0, 350 0, 75 0); 